home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 043a / compoz.zip / COMPOZ.DOC < prev    next >
Text File  |  1991-11-06  |  19KB  |  510 lines

  1.                                 COMPOZ Ver. 1.0
  2.                                 A Music Utility
  3.  
  4.                                  John M. Coon
  5.                               11 Meadow Wood Dr.
  6.                              Fairport, N. Y. 14450
  7.                            Compuserve I.D.# 73067,1666
  8.  
  9.  
  10.     INTRODUCTION
  11.  
  12.     COMPOZ is a program which takes advantage of the excellent
  13.     music reproduction capabilities of CREATIVE MUSIC's SOUND
  14.     BLASTER Card for IBM and IBM Compatibles.
  15.     It represents the culmination of a six month effort
  16.     to produce a simple but efficient and easy to use software
  17.     product for generating CREATIVE MUSIC ".CMF" Files.
  18.  
  19.  
  20.     PURPOSE
  21.  
  22.     Created for the IBM PC and Compatibles, COMPOZ offers
  23.     musicians and non-musicians alike the ability to compose
  24.     multi voice scores or input their favorite sheet music. The
  25.     resulting ".CMF" File can then be played back within COMPOZ
  26.     or with one of the many player programs now available.
  27.  
  28.  
  29.     HARDWARE REQUIREMENTS
  30.  
  31.     IBM PC or Compatible (286 or better recommended)
  32.     640 K
  33.     CGA or better required
  34.     SOUND BLASTER CARD
  35.     Mouse (optional - recommended)
  36.     Hard Drive or Floppies
  37.  
  38.  
  39.     BRIEF DESCRIPTION
  40.  
  41.     Up to nine voices are programable with any of sixteen
  42.     instruments from the built in instrument cache or imported
  43.     from your directory of ".SBI" instrument files. Notes can be
  44.     input either by mouse or keyboard over a seven octave range.
  45.     Sharps, flats and natural's are supported, as are dotted
  46.     and tied notes.
  47.  
  48.     The screen displays three measures of treble and G cleff
  49.     staffs, up to a total of 60 measures or twenty pages.
  50.     Menu options are at the top of the screen and editing tools
  51.     are at the bottom, all of which respond to mouse or keyboard
  52.     activation.
  53.  
  54.     Notes become part of an alpha-numeric coded file which when
  55.     saved will have the file extension: ".CPZ".
  56.     This ".CPZ" File may then be edited or re-edited, instrument
  57.     assignments changed, tempo altered, etc.
  58.  
  59.     COMPOZ can convert these files to a ".CMF" file for playback
  60.     via the play menu or saved via the file menu. Instruments for
  61.     the voices may be selected from the instrument cache and
  62.     assigned to individual voices. Each instrument's velocity or
  63.     volume setting may also be assigned.
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                 Page 2
  71.  
  72.     The default instrument "Pianoj" is assigned to all voices at
  73.     start up.
  74.  
  75.     Instrument and velocity selections for the voices are saved
  76.     with the ".CPZ" File. Instruments in the instrument cache may
  77.     be replaced with any ".SBI" instrument files available to the
  78.     user. These imported instruments will be valid until they are
  79.     changed or the current session ends.
  80.  
  81.     The instrument cache contains sixteen different instruments,
  82.     each of which may be assigned to all or different voices.
  83.  
  84.  
  85.     LOADING COMPOZ.EXE-----------------------------------------
  86.  
  87.     To load COMPOZ you should either load your mouse
  88.     driver (optional) and SBFMDRV.COM, the FM Music Driver which
  89.     comes with your SOUND BLASTER Card, first and then
  90.     COMPOZ.EXE.
  91.     Or create a batch file similar to the following:
  92.     @ECHO OFF
  93.     CD MOUSE
  94.     MOUSEDRIVER
  95.     CD C:\SB
  96.     SBFMDRV.COM
  97.     CD COMPOZ
  98.     COMPOZ.EXE
  99.     CLS
  100.     CD C:\
  101.  
  102.     The program expects to find the SOUND BLASTER Card at address
  103.     220H. If it does not it will flag you that the card cannot be
  104.     found. It will also flag you If you fail to load the FM
  105.     driver.
  106.  
  107.  
  108.     THE MENUS--------------------------------------------------
  109.  
  110.  
  111.     File Menu:
  112.                1 - Load a music text file (.CPZ) for conversion
  113.                    to a (.CMF) file or for editing.
  114.                2 - Save a music text file (.CPZ) to disk.
  115.                3 - Create a new music text file (.CPZ).
  116.                4 - Load a .CMF File for playing.
  117.                5 - Save a .CMF File -  (Converted (.CPZ) File.)
  118.                6 - Set Directory Paths for (.CPZ), (.CMF) and
  119.                    (.SBI) Files
  120.                7 - Convert (.CPZ) File to a (.CMF) File
  121.                8 - Shell to DOS
  122.                9 - Clear the (.CPZ) and (.CMF) working buffers
  123.               10 - Exit COMPOZ
  124.  
  125.     Options Menu:
  126.                1 - Assign instruments to the voices
  127.                2 - Restore default instrument
  128.                3 - Set the tempo for a working (.CPZ) File.
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                 Page 3
  137.  
  138.                4 - Clear the highest voice in a working (.CPZ)
  139.                    File.
  140.                5 - Sound On/Off - enable instrument sound for
  141.                    voice being entered into a working (.CPZ)
  142.                    file.
  143.                6 - Sequence - set the sequence of measures for
  144.                    repeats and CODAs of a finished working (.CPZ)
  145.                    file.
  146.                7 - Instrument Cache - contains the sixteen built
  147.                    in instruments and provision for importing
  148.                    external instrument files.
  149.                8 - Active File Info displays instrument and
  150.                    velocity assignments, tempo, number of
  151.                    measures and number of voices of a (.CPZ)
  152.                    file.
  153.  
  154.     Play Menu:
  155.                1 - Play - Plays a converted (.CPZ) file or any
  156.                    imported (.CMF) file.
  157.                2 - Play Voice - Converts and plays the active
  158.                    voice of the current working (.CPZ) file.
  159.                3 - Pause - Pause music output.
  160.                4 - Resume - Resume music output.
  161.                5 - Quit - Stops the current play function.
  162.  
  163.     Help Menu:
  164.                1 - File Help
  165.                2 - Option Help
  166.                3 - Play Help
  167.  
  168.  
  169.     THE EDITING TOOLS -----------------------------------------
  170.  
  171.  
  172.     NOTELENGTH - Selects 1/16, 1/8, 1/4, 1/2 or whole notes as
  173.                  next note to be input.
  174.                  Up - Increase notelength
  175.                  Dwn - Decrease notelength
  176.                  "." - Changes 1/8, 1/4 and 1/2 notes to dotted
  177.                        notes.
  178.  
  179.     TIE On Off - Causes next note to be input to be tied to the
  180.                  following note input within or across measures.
  181.                  Will NOT tie notes of different pitch. Resets to
  182.                  Off after note input.
  183.  
  184.     REST On Off - On causes next note to be input to be a rest.
  185.                   Resets to Off after note input.
  186.  
  187.     VOICE NUMBER Up Dwn - Changes current active voice, 1 thru 9.
  188.  
  189.     SIG Up Dwn - Set the music Signature i.e. 4/4, 2/4, 3/4, 6/8
  190.                  Beats per measure.
  191.  
  192.     # % b - Sets next note to be input either sharp, flat or
  193.             natural. Resets after note input.
  194.             Also sets music key. Set key on Treble Staff to right
  195.             of signature.
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                 Page 4
  203.  
  204.     OCTAVE Up Dwn - Sets the octave for music input and viewing.
  205.  
  206.  
  207.     USING COMPOZ------------------------------------------------
  208.  
  209.     KEYBOARD HELP
  210.  
  211.     KEY                               FUNCTION
  212.     ____________________________________________________________
  213.     HOME             Moves cursor to left edge of screen
  214.     END              Moves cursor to right edge of screen
  215.     LEFT ARROW       Moves cursor one column to the left
  216.     RIGHT ARROW      Moves cursor one column to the right
  217.     UP ARROW         Moves cursor one row up
  218.     DOWN ARROW       Moves cursor one row down
  219.     PAGE UP          Moves cursor to top of screen
  220.     PAGE DWN         Moves cursor to bottom of screen
  221.     ENTER            Selects function under cursor or inputs Note
  222.                      If cursor is at extreme left or right edge
  223.                      of screen and on a staff, ENTER will cause a
  224.                      page change down or up. If cursor is at
  225.                      extreme left or right edge of screen and
  226.                      positioned between the staffs then ENTER
  227.                      will cause a move to page one or the last
  228.                      page respectively.
  229.  
  230.     TAB              Moves cursor 10 columns right
  231.     SHIFT TAB        Moves cursor 10 columns left
  232.     BACKSPACE        Erases note under cursor (active voice)
  233.     CTRL BACKSPACE   Erases measure under cursor (active voice)
  234.  
  235.  
  236.     MOUSE HELP
  237.  
  238.     Move mouse cursor over function and press left Mouse button.
  239.  
  240.     Move mouse cursor to selected spot on music staff and press
  241.     left Mouse button to input a note, press right Mouse button
  242.     to erase the note for the active voice. To erase the measure
  243.     for the active voice, press both Mouse buttons
  244.     simultaneously.
  245.  
  246.     The mouse cursor may be moved all the way to the right side
  247.     of the screen on the note staffs and the left Mouse button
  248.     pressed to pagechange up to the next page. Conversely the
  249.     mouse cursor may be moved all the way to the left on the
  250.     staffs and the left Mouse button pressed to change pages
  251.     down.
  252.     If the Mouse cursor is kept between the staffs and moved to
  253.     the extreme left or right side of the screen, then when the
  254.     left Mouse button is pressed the pagechange will take you to
  255.     page one or the last page and last measure respectively.
  256.  
  257.     ENTERING AND EDITING NOTES
  258.  
  259.     Position the cursor where the note should be placed on the
  260.     staff and press ENTER (Mouse left button). The editor will
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                 Page 5
  269.  
  270.     not allow a note to be entered over another note, it's flag
  271.     or over a measure separator.
  272.     Erase a note by positioning the cursor over the note and
  273.     pressing BACKSPACE (Mouse right button).
  274.     Erase a measure by positioning the cursor within the measure
  275.     to be erased (for the active voice only) and press CTRL
  276.     BACKSPACE (Both Mouse buttons).
  277.  
  278.     Voices are assigned colors for identification while editing.
  279.     Example: Voice 1 notes will be black on the white
  280.     background edit screen. You cannot erase or edit notes of a
  281.     voice (color) that is not the current active voice. Voices
  282.     are selected with the edit tool VOIVE NUMBER Up/Dwn.
  283.  
  284.     If you select SOUND ON from the options menu the active
  285.     voice's assigned instrument will be heard as notes are
  286.     entered.
  287.  
  288.     The default signature is 4/4 time. In this sig you are
  289.     allowed to enter any combination of notes that add up to 4
  290.     beats.
  291.             Whole note = 4 beats   (1 per measure)
  292.             1/2 note   = 2 beats   (2 per measure)
  293.             1/4 note   = 1 beat    (4 per measure)
  294.             1/8 note   = .5 beat   (8 per measure)
  295.             1/16 note  = .25 beat  (16 per measure)
  296.             Dotted 1/2 note = 3 beats
  297.             Dotted 1/4 note = 1.5 beats
  298.             Dotted 1/8 note = .75 beat
  299.     The program will not let you exceed the beats per measure as
  300.     set by the signature.
  301.  
  302.     To set the key of the music (sharps or flats) you will need
  303.     to select from the edit tools line either the sharp or flat
  304.     character and move the cursor two columns to the right of the
  305.     signature on the Treble cleff staff and press the left mouse
  306.     button or ENTER to write the flat or sharp key identifier. If
  307.     the flat character is selected and the music is in B flat
  308.     then position the cursor over the third line down and two
  309.     columns right of the signature within the Treble Cleff and
  310.     enter the flat. The flat will be printed at the appropriate
  311.     place on the G Cleff staff as well.  All B notes entered will
  312.     now be flat. To enter a natural B the natural character must
  313.     be selected before entering the natural B. The natural sign %
  314.     will be added to the note when printed on the screen. The
  315.     natural character will need to be selected before entering
  316.     each natural B, even within the same measure as it will
  317.     default back to the B flat key.
  318.     If a note that would be normally natural by key assignment
  319.     such as a C in the key of C (no flats or sharps) is needed to
  320.     be made sharp or flat then select the sharp or flat character
  321.     from the edit tools row and then enter the note. A # or b
  322.     will be added to the note on the screen indicating the
  323.     choice. This will have to be done each time a note is to be
  324.     made sharp or flat, even within the same measure as it will
  325.     default back to the C key (no sharps or flats).
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.                                 Page 6
  335.  
  336.  
  337.     If a note is tied to a note of the same pitch be sure to
  338.     select the tie function in the edit tools row before entering
  339.     the note.
  340.  
  341.     If REST On is selected a rest character will be printed to
  342.     the screen at the notelength selected. In the 4/4 signature
  343.     (4 beats per measure) to rest for the whole measure select 1
  344.     for the notelength (whole note) and REST On then enter.
  345.  
  346.     When inputing music, select voices in ascending order. Input
  347.     all or several pages of voice 1 then change the voice number
  348.     assignment to voice 2 etc. and input voice 2 to match the
  349.     measure count for voice 1. You may then convert the ".CPZ"
  350.     file to ".CMF" and play it to check your progress.
  351.     Once a voice has been selected and notes input that voice
  352.     must either have notes or rests assigned to the active
  353.     measures already written in previous voices. In other words
  354.     if the music you are inputing has 6 voices but the sixth
  355.     voice is only used occasionally, then you must fill the
  356.     measures where voice 6 is not used with rests.
  357.     If you increment to a voice and input notes by mistake or
  358.     just want to eliminate that voice, then go to the options
  359.     menu and select Clear Voice to clear it.
  360.  
  361.     Convert file may be selected at anytime from the File menu to
  362.     listen to the music up to the last entry point, however all
  363.     active voices must be complete to the last measure with notes
  364.     or rests.
  365.     If a voice is not complete or there has been an input error
  366.     (not enough notes entered in a measure etc.) an error window
  367.     will appear displaying the voice and measure number where the
  368.     error was detected.
  369.  
  370.     A voice may be assigned one instrument only. This instrument
  371.     may be changed at any time in an active ".CPZ" File but it
  372.     will be the only instrument for that particular voice.
  373.  
  374.     If you assign a voice an instrument that was imported into
  375.     the instrument cache it will be good for that session only.
  376.     If the ".CPZ" file is brought in at a later time the
  377.     instrument assignment shown in the options menu selection
  378.     <CPZ File Info> will be incorrect and if the file were to be
  379.     converted the imported instrument slot would default back to
  380.     the built in instrument cache instrument.
  381.  
  382.     COMPOZ will not handle triplets or 1/32 notes.
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.                                      Page 7
  401.  
  402.  
  403.     TYPICAL PROGRAM EXAMPLES
  404.  
  405.     You load an existing ".CPZ" file and want to change the
  406.     instruments for voice 1 and 2. First load the file by
  407.     selecting <Load .CPZ File> from the File menu. You will be
  408.     presented with all of the ".CPZ" files in the directory which
  409.     was set with the <Setpaths> option of the File menu. Select
  410.     the file. After the file is resident and notes are displayed,
  411.     select <Assign Instruments> from the Options menu. Enter the
  412.     voice number to change at the prompt. Enter the number of the
  413.     instrument to assign from the instrument cache listing on the
  414.     left of the window. Enter the velocity level of the new
  415.     instrument. Do this for both voice 1 and 2. Press the escape
  416.     key and convert the file by selecting <Convert File> from the
  417.     File menu. You may now play the music with the new
  418.     instruments by selecting <Play> from the Play menu. If you
  419.     want to save the music as a ".CMF" File then select <Save
  420.     .CMF> from the File menu, give it a name and save it to the
  421.     directory you selected for ".CMF" Files with the <Setpath>
  422.     option of the File menu. Remember that ".CPZ" Files must be
  423.     converted to be saved as ".CMF" Files.
  424.  
  425.     You would like to replace one of the built in instruments in
  426.     the instrument cache with one of your favorite ".SBI"
  427.     instrument files. Select <Instrument Cache> from the options
  428.     menu and enter the number of the instrument to replace. You
  429.     will see all of the ".SBI" files in the directory that was
  430.     set by <Setpaths> in the File menu. Select the instrument
  431.     file to import and press enter. Press escape to exit the
  432.     instrument cache option. Next select <Assign Instruments> to
  433.     assign your imported instrument to a voice.
  434.  
  435.     Load the example .CPZ files included in this package to see
  436.     the note and rest representations on the screen and how the
  437.     <Sequence> option of the Options menu works. Modify the files
  438.     by changing instruments, velocity or tempo, convert and play
  439.     them to hear the changes.
  440.  
  441.  
  442.     COMPILER
  443.  
  444.     COMPOZ was written and compiled in Microsoft Basic
  445.     Professional Development System ver. 7.1.
  446.     Some of the routines in COMPOZ are from Crescent Software's
  447.     Quickpak PRO-7 Library.
  448.     Other Library routines in support of the Sound Blaster card
  449.     are from Creative Labs SB Developer Kit
  450.  
  451.     Quickpak, PRO-7 - Copyright Crescent Software
  452.     Microsoft Basic PDS 7.1 Copyright Microsoft Corp.
  453.     Sound Blaster, Sound Blaster Developer Kit, CMF, SBI
  454.                                  Copyright Creative Labs
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.                                       Page 8
  468.  
  469.  
  470.     IMPORTANT
  471.  
  472.     COMPOZ is distributed as a fully working program. There are
  473.     no disabled file functions or delay screens and it is not a
  474.     "Demo".
  475.     This program may be distributed and copied freely as long as
  476.     this documentation file is included. COMPOZ is a Shareware
  477.     product and is intended to be used by individuals to enhance
  478.     their enjoyment of composing or playing music through the
  479.     Sound Blaster Card. COMPOZ is a copyrighted program and may
  480.     not be sold individually, included as part of prepackaged
  481.     software or for any commercial purpose.
  482.     Disk distributors of Shareware or user supported software may
  483.     distribute COMPOZ for a reasonable fee to cover costs of
  484.     duplicating and handling.
  485.  
  486.  
  487.     REGISTRATION
  488.  
  489.     COMPOZ is Shareware and you are asked to evaluate the
  490.     software for a reasonable amount of time. If after this
  491.     time you find yourself continuing to use the program you must
  492.     register it. The Registration fee is $20.
  493.  
  494.     Send registration fee of $20.00 To:
  495.  
  496.                                            John M. Coon
  497.                                          11 Meadow Wood Dr.
  498.                                         Fairport, N.Y. 14450
  499.  
  500.     N.Y.S residents add 7% sales tax. ($21.40)
  501.  
  502.  
  503.     DISCLAIMER OF LIABILITY
  504.  
  505.     This program, its use, and operation are provided "AS IS"
  506.     without warranty of any kind, either expressed or implied.
  507.     The entire risk as to the quality and performance of this
  508.     software is with the user. In no event shall I, John M. Coon,
  509.     be liable for damages arising from the use or inability to
  510.     use this program.